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GETTING STARTED 



This section helps you to get your Pegasus up and running. 
It describes aspects of Pegasus operation which you will 
need to know no matter which language you are using. 

If you have not got your Pegasus up and running yet, refer 
to Appendix One of this section. 

At this point you should have a Menu on the Screen like 
this :- 

AAMBER Pegasus 6809 
Your Name 

Basic 1.2 
Monitor 2.0 

Select one of above: 

This is always the way the Pegasus powers up. It has 
scanned through memory and found what programs are present 
and written these into the menu. If your menu is different 
from that above it is likely you have different Sproms 
installed. (If you want to change eproms refer to Appendix 
2 at the back of this section) . Eproms are the integrated 
circuits on your board which have labels on them. They 
contain software such as the Monitor and Basic. 



The Monitor Eprora must never be removed. Without it your 
Pegasus will not function. The other two Eprom sockets may 
have any of a wide range of languages; a list of some of 
these follows: 



Language 

Basic 

Forth 

Pascal 

Word Processor 

Micro Assembler, 

Disassembler 



Ho. of Eproms 

1 eprom 

2 eproms 
2 eproms 
1 eprom 

1 eprom 



Appendix 



Ah Eprom expansion board is available so that all languages 
can be installed at once. Otherwise you should install the 
language you wish to use - (refer to Appendix 2). 



Any of the programs in your Menu can be activated by typing 
the first letter of the entry. The program once entered 
should reply with some form of prompt. The monitor will reply 
with a > , Basic with ready etc. A list of some of the 
available programs on eprom and some on cassette which will 
have Menu entries is given in Appendix 3. 



Finally the REPEAT key on the Pegasus is not used. All 
keys which produce Ascii codes (i.e. all except ESC, BREAK, 
INVFLAG and RAWFLAG) , have an automatic repeat feature. 
After being held down for approximately one half second the 
characters will appear repeatedly at the rate of 8 character; 
per second until the key is released. 

Another feature of the Pegasus Keyboard is 2 - key rollover. 
This means that a key can be pressed before the previous 
one is released and is essential for fast typing. 



Control Codes 

The Pegasus Control Codes are invoked by holding the 
control key down and then typing one of the alphabetic 
characters. They have various functions which may not 
appear useful to you at this stage. Basic is again the 
best way of experimenting with what they do. Most of them 
are more useful in programs than for use by typing at the 
keyboard. 



Set inverse video mode 

Clear inverse video mode 

Disable graphics display 

Move cursor right 

Move cursor Up 

Turn cursor On 

Enable Graphics Display 

Same as BACK SPACE 

Same as TAB 

Same as LINEFEED 

Set cursor position 

Form Feed 

Same as RETURN 

Scroll Screen Up 

Turn Cursor Off 

Turn on Clock 

Turn off Clock 

Move Cursor Left 

Home Cursor 

Clear Line 

Scroll screen down 

Move Cursor down 

Read Graphic Character 

Program Graphics Character (not avail from keyboard) 



CTRL 


A 


CTRL 


B 


CTRL 


C 


CTRL 


D 


CTRL 


E 


CTRL 


F 


CTRL 


G 


CTRL 


H 


CTRL 


I 


CTRL 


J 


CTRL 


K 


CTRL 


L 


CTRL 


M 


CTRL 


N 


CTRL 





CTRL 


P 


CTRL 


Q 


CTRL 


S 


CTRL 


T 


CTRL 


U 


CTRL 


V 


CTRL 


X 


CTRL 


Y 


CTRL 


C 



PLUGGING INTO TELEVISION 



3 or 4. 



Turn off television. 

Remove aerial. 

Replace with modulator connections. 

Turn on television and turn to channel 

Turn on Pegasus. 

Tune in television by the use of the fine tuner. 

If this does not work, try channels 1 to 4 on the 

television in turn, adjusting first the television 

fine tuner then by the use of a small flat screwdriver 

through the hole in the modulator, the modulator 

tuning. BEWARE, THIS IS SENSITIVE. 

Look for prompt, and menu. 



Aamber Pegasus 6809 



B BASIC 



M MONITOR 



To return to the Menu, hit the "Panic" button, 



A - 9 



CASSETTE RECORDERS 



APPENDIX 3 
MENU ALLOCATION 



It has come to our attention that some cassette recorders 
invert the data put into them on record and playback. 
While this has no effect on programs recorded and played 
back on the SAME cassette recorder, it can cause problems 
when tapes are recorded on one machine and played back on 
another. In our experience this problem does not occur 
very often, but if it does, the following procedure 
should be adopted: 



If a tape obtained from someone else (THAT HAS NO SECURITY) 
fails to load on another recorder at the normally good 
volume setting then you should: 



1. 



Unplug the cassette lead from the Pegasus 
(and unplus 'MIC from the recorder. 
Reinsert it as shown below. 
Try to load the tape again as normal. 

: This will in no way improve cassette reliability 
or help with faulty tapes or recorders - it will 
only assist with the rare situation where the 
recorder inverts the data. 

Once a correct load has been obtained the cassette 
lead must be replaced in its normal position and the 
program saved again on another tape. This new tape 
will then work with that recorder without problems. 
Save will not work unless the lead is in its normal 
position. 




Assembler 
BASIC 



Disassembler 



E 


- 




F 


- 


FORTH 


G 


- 


Galaxy Battle 


H 


- 




I 


- 


Invaders 


J 


- 





Monitor 
Network 



Word 

Extended BASIC 



Circuit board 



key 



NOTE: Diagram shows cassette lead plugged in 'upside down 
and shifted two holes to the right. 



THE 



When your Pegasus powers up, it has amongst its Menu 
items the "MONITOR". Only a small part of it becomes 
active when you type "M" and "enter" the monitor. Most 
of it is actually in constant use by your Pegasus. It 
is the heart that keeps your Pegasus beating. Some of 
the functions which the monitor performs are listed 
below: - 



1) Display the Menu and jump to the program 
selected 

2) Scan the keyboard and return Ascii codes to 
programs 

3) Send characters to the screen, and look after 
the cursor and control codes 

4) Perform Video Scanning 

5) All cassette loading and saving routines 

6) Graphics programming and reading 

7) Monitor Commands (e.g. view and change memory) 

8) Keeps System Clock 

9) Clears all memory on power up and determines 
memory beginning address 

10) Provides routines for outputting and inputting 
text strings and numbers 

11) Vector interupts through ram 

You do not need to understand anything about the Monitor 
in order to use Pascal, Forth or Basic, However, if you 
are interested in microprocessors at the machine level 
or how your Pegasus works then the following will be 
of interest to you. 



USER SUBROUTINES 

There are several subroutines provided in the Monitor 
exclusively for use by the USER.-- Basic for instance uses 
the routines extensively, and any machine programs you write 
may use them too. -In order that your programs (and ours) 
are compatible with any version of the monitor, all these 
routines have pointers to them. The pointers are always at 
a fixed location even if the routines themselves are not. 
To use the routines you should use indirect addressing, 
e.g. JSR (ECHO) which assembles to: ( AD 9P P8 00). 
Appendix 1 contains a description of all such subroutines 
along with its respective pointer address. By far the biggest 
of these routines is ECHO. ECHO effectively simulates an 
output terminal with full cursor facilities, scrolling and 
many other functions. All the high level languages on the 
Pegasus use ECHO for output. The next section describes 
ECHO in more detail. Appendix 2 gives a summary of ECHO'S 
control codes. ECHO'S partner, so to speak, is the routine 
INPUT. By contrast it is very short but it is where the 
Pegasus spends a lot of its time, waiting for you to type a 
key. 



THE USER SUBROUTINE ECHO 



Due to the complexity of this subroutine a full section is 
devoted to its use. ECHO receives characters in the A 
accummulator and puts them on the screen at the current 
cursor location. The cursor is then moved one position. 
All Ascii characters between $20 and $7F and between $Aj0 
and $FF are treated in this manner. If the Most 
significant bit is set the character will be displayed 
with inverted video unless the invert video flag INVERT is 
set. Characters between $00 and $1F and between $80 and 
$9F are control characters. They will perform a special 
function unless a flag called RAWMODE (see monitor system Ram - 
Appendix 7) is set when they will be displayed as Greek or 
special characters as per the table in Appendix 4. This 
makes all the shapes in the character generator ROM available 
for display through ECHO. However, the RAWMODE flag must be 
set and cleared directly by USER programs. A suitable way 
to do this in Basic for instance is to use POKE. 

The control codes themselves are summarised in Appendix 2, 
along with their hexadecimal and decimal equivalents. Control 
A and B set and clear the invert video flag INVERT. The 
normal value of this flag is $80. Control C and G take the 
Pegasus in and out of graphics mode. In other words the 
normal character generator ROM is substituted for a RAM 
character generator (if installed). Before this is done, 
however, it is necessary to program the RAM character 
generator with the desired character shapes using control 
C (ESC) See Graphics Section. The use of the ESC code here 
is not to be confused with the ESC button of the keyboard. 
When you type ESC at the keyboard it does not generate the 
ascii ESC code. It just halts ECHO internally. When ESC 
code is sent to the ECHO subroutine it causes ECHO to use 
the next 17 bytes sent to it for programming a graphics 
character. 

Control D,E,S and X move the cursor right, up left and down 
respectively, while control F and turn it on and off, by 
clearing or setting a system byte called cursoff. The cursor 
can be made non-flashing by storing $01 into CURSOFF although 
no control code will do this. 

Control H,J and M are equivalent to BACKSPACE, LINEFEED and 
RETURN respectively and all perform the expected function. 
There is no automatic Linefeed on carriage return. The tab 
character will advance the cursor 6 spaces although USER 
programs can process them in a more sophistocated manner if 
required, e.g. the Word Processor. 

Control K followed by two further calls to ECHO will set the 
cursor position to the X and Y co-ordinates received. 



Control L performs the form feed function and 



Control T performs the cursor home function. 

Control N and Control V can be used to scroll the screen 
up or down without affecting the cursor position. 

Control D" clears the line that the cursor is currently on. 

All cursor movements past the left or right margin of the 
screen normally result in it re-appearing at the other 
margin on the next line above or below. This can be 
prevented by clearing the flag AUTOLN. 

Finally, the two control codes P and Q can be used to turn 
on and off the display of the system clock. 



THF SYSTEM MONITOR 

Your Pegasus System Monitor resides in a 4K EPROM, starting 
at address $F0OO. (See Memory Map.) The system assumes 
that a minimum of IK of RAM exists, from $BCO0 to $BFFF. In 
most Pegasi, there will be 4K, from $B000 to $BFFF. When the 
Pegasus first powers on, a memory test is done that will 
establish where the system's contiguous RAM resides - 
contiguous means that there are no gaps in it. ( Please note 
that the Pegasus simply will not work unless there is a 
system monitor EPROM inserted correctly in its socket.) The 
beginning and end addresses of user RAM will be derived, and 
stored in RAM at locations MEMBEG ($BDF2) and MEMEND ($BDF4) 
respectively. The value in MEMEND will usually be $BD9E, 
which is the normal end of user RAM (and also the system stack 
origin) , while the value in MEMBEG will vary depending upon 
the amount of RAM installed, typically being $B000. 



VIDEO RAM AND STACK 

There are 512 bytes ($0200) reserved for the video display 
RAM, from $BE00 to SBFFF. Video RAM is organised as 16 lines 
of 32 characters each, where each character has 8 bits. The 
top left corner character position equates with $BE00, while 
bottom right is $BFFF. Characters in this RAM will be 
displayed on screen as their ASCII equivalents ( unless graphic; 
mode is operational ) , with the MSB indicating reverse video - 
if 1 (high), then characters will appear as normal, light on 
a dark background, while a (low) here will cause the 
character to be inverted. You may modify video RAM directly 
under program control, but this is not recommended unless you 
know exactly what you are doing. 

The system stack is a collection of bytes that starts at 
$BD9F and grows downwards towards low memory. The stack is 
maintained by the stack pointer register, and is used for 
controlling program flow and subroutine linkage. The amount 
of memory used by the stack varies, but is typically less than 
30 bytes. Note that monkeying with memory near the stack 
( $BD9F) can cause your system to crash. 



SYSTEM VARIABLES 

There are 96 bytes permanently reserved for special use, 
occupying addresses from $BDA0 to $BDFF inclusive. These 
are byte and word variables,, that are used by the monitor 
for various housekeeping functions, many of which are 
available to the user. Some of these locations are byte 
flags, or booleans, and may be changed or tested by user 
programs, while others are reserved for system use, so 
that changing them could cause unpredictable results to 
occur. A summary of these variables can be found in 
Appendix 7. 

The system monitor may be entered with 'M' for 'Monitor'. 
The prompt used for monitor commands is the greater-than 
symbol, > . A summary of monitor commands is given below: 



hhhh 

GO function - machine language programs may be executed 
simply by typing the desired starting address. If you 
wish execution to occur, type the ' . ' key; any other 
key typed will abort back to the monitor. 

hhhh 

LOAD function - the load operation will read data from 
the cassette interface into RAM. The data loaded will 
be a contiguous region of memory, and the load start 
and end addresses will be displayed, along with the 
filename that was used when saving the file. A new loac 
start address may be specified to relocate the file on 
loading. 



VERIFY - this is similar to load except that data read 
from the cassette will not alter the appropriate locat- 
ions in memory. This is useful for verifying that a 
program has SAVEd or LOADed successfully. 

M hhhh 

MODIFY function - a memory address is specified, and 
the byte found there will be displayed. You may proceed 
to the next byte with the ' . ' key, and move to the previous 
byte with the ',' key. A new address may be specified by 
typing the 'M' key. At any stage, the byte at a RAM 
location may be changed, simply by entering a new, two 
digit hex value. If the location was not changed, then 
the contents of the location are redisplayed. 

T hh mm ss 

The time may be set using the TIME function 
is measured in hours, minutes and seconds. 



ver 1.2 ha; 



, ~^w „..„.., ^,.^ »*«•* .uL^Liu... The time 
hours, minutes and seconds. Mote that 
24 hour clock system. 



S hhhh hhhh 

SAVE - a block of data between the given start and 
end addresses will be saved on cassette tape. A 
filename may be specified. The screen will blank 
for the duration of the SAVE operation. 



MEHU Items 

If you want programs which you have written and have in 
memory to appear in the Menu when you go back to it, the 
following convention should be used. 
Starting on a IK boundary assemble the following - 

BRA CONT 

FCB "Name to appear in Menu", $00 

FDB $0000 
CONT. 

When the Pegasus writes the menu it searches all the IK 
boundaries for a branch opcode followed by an offset of 
$20 or less. A Message of up to 29 characters may follow. 
It must be terminated with three $00 bytes. 



i Appendix 1 

USER ACCESSIBLE PEGASUS SYSTEM MONITOR SUBROUTINES 



The Aamber Pegasus System Monitor EPROM contains a number of 
machine language subroutines that may be found to be of use. 
Each routine is called via a table of addresses, using the 
6809 indirect addressing mode. E.d. ECHO is called with AD 
9F F8 00. 



ECHO 



SF800 f-5.3 R 

ASCII character in A reg. is output to video 
display. All registers are preserved. Can be 
revectored. See Appendix 7 under ECHOVEC. 

$F802 fS¥i f-j£4-3> fen-tSA*, c 

Waits for key to be typed, returns ASCII value 
0..7F in A reg. Character is not echoed. Can 
be revectored. See Appendix 7 under INPUTVEC. 
All registers preserved except A,CC 

SF804 f$$ft 

Scans keyboard for keystroke. If key found, it 
will be returned in A reg. with carry clear - 
if not found, then carry will be set and A will 
be undefined. Character not echoed. All 
registers preserved except A,CC 

$F806 Pi£C 

Re-entry point into machine language monitor 

$F808 f%cU 

Outputs data to cassette recorder with start and 
end addresses in locations START and FINISH. 
(See Appendix 7). Record button on recorder must 
be going. All registers preserved except A and B 

$F80A ng3 

Reads the next file from cassette tape, assuming 
that the play button has been pushed. Leaves load 
address of file in START and end address in FINISH 
- See Appendix 7. All registers preserved except 
A, B and CC 



c 



r 



TRIMCASE $F80C f g9° 

Character in A reg. is converted from lower case 
to upper case. Also, '.' becomes '< ' and ',' 
becomes •> ' . All registers oreserved except A, 
CC 

HEXOUT $F8 0E fBFl5 

Takes number in A reg., displays as two hex digits. 
All registers preserved except A,CC 



GETLINE 



O 



GETNUM 



5F810 fgC% 

Takes digit 0..F in A reg, converts to ASCII 

'0'..'F'. All registers preserved except A, CC 

5F812 fcl£ 

Reads two hex digits from keyboard, echoing if 

valid, returns 8 bit number in A reg. Carry set 

if not valid. All registers preserved except 

A,CC 

$F814 f£4it 

Inputs line into buffer pointed to by X reg. on 
entry. Buffer size given by A reg. Line termin- 
ated with RETURN key (echoed as CR,LF pair) . 
Characters are echoed as they are typed, and may 
be corrected with the BACK SPACE key. The control 
-U function will clear the buffer. On return, 
the A and X regs. are preserved, and B contains a 
byte count of characters typed. The RETURN will 
not be in buffer. All registers are preserved 
except B and CC 

$F816 f^AC 

Output string pointed to by X reg, terminated with 
nul ($00). The X reg. is left pointing to the byte 
after the nul. All registers are preserved except 
A and CC. 

$F818 ff&7 

See discussion of Pegasus graphics capabilities. 

All registers preserved except X. 

$F81A f£|7 

Reads and echoes a decimal digit from keyboard, 
returning in A reg, carry set if non-numeric digit 
was typed. All register preserved except A,CC 

$F81C fsfp 

Reads and echoes decimal number range 00 to 99 
from keyboard, returns in A reg. Non-numeric means 
carry set. All registers preserved except A,B,CC 

$F81E fs^ft 

Takes decimal number, range 00 to 99 in B reg., 

converts to two ASCII characters in the D reg. 

( A and B regs.) All registers preserved except 
A,B,CC 



SF822 (-Q&0 

Entry point back to Menu selection mode in 

Monitor 

$F824 fg£J> 

Tests ASCII char, in A reg. for range '0' to 
'F'. If not in range, returns with carry set, 
else digit returns in A. All registers preserved 
except A,CC 

$F826 f £o£ 

Causes cursor to move to start of next line. This 
routine simply calls ECHO, firstly with CR then 
with LF. All registers preserved except A,CC 

5F828 r^M 

Equivalent to control-L: clears the video screen. 
Does not call ECHO. All registers preserved 
except CC 

$F82A ftP"? 

Clears line that cursor is on - same as control-U 

Does not call ECHO . All registers preserved except 

CC. 

SF82C ft£?3 

Outputs one space to screen at current cursor 

position. All registers preserved except CC 

$F82E ftC^ 

Homes cursor to top left corner - same as control-T 

All registers preserved except CC 

$F830 {c PiO 

Nul function - has no effect 

$F832 [=c4^ 

Similar to TEXTOUT, except that a NEWLINE is done 

first. 



r> 



$F820 r-c3.fi 

Gets four hex digits from keyboard, echoing them. 
Returns number in X reg. Carry set if non-hex 
typed. All registers preserved except A,B,X,CC 






USERS NOTE 



The initialization done by the monitor at various times has 
been designed to allow easy recovery from crashed programs. 

POWER UP - initializes everything and clears memory 



initializes everything except MEMBEG, MEMEND 
and PC-REG 



RETURN TO MENU OR ENTERING MONITORS - initializes only the 
system variables which control the keyboard and display. 
These are MSBINV, RAWFLAG , CAPSLOCK, KEYLOCK, RXREADY, ABORT 
(break) vector; INVERT, RAWMODE, CURSOFF, PAUSING, LINES, 
AUTOLN and clears graphics mode and clears the F interrupt 
mask bit. This gives a standard keyboard and display while 
leaving all your other variables, vectors and PIA's etc 
untouched. While Reset is the No. 1 tool for recovering 
from crashed programs, a separate NMI button is sometimes 
useful as a way of getting back to the Monitor prompt with- 
out initializing everything back. The NMI interrupt is 
vectored to take you straight into the monitor prompt. A 
prime exmaple is when you have your own printer drivers 
installed in RAM and you have revectored the printer routines. 

If you do a reset it will change these vectors back to the 
Centronics routines. Your routines would still be safe 
however because Reset does not change MEMBEG or MEMEND and 
the stack always starts at MEMEND {Version 2-3) . 

The NMI interrupt can be used for other purposes because it 
is vectored through RAM at location $B002 

Anytime you are in the monitor you can cause the reset 
initialization to run by typing "R" . 

The printer routines can be used/from programs as they have 
vectors pointing to them at $F834 and SF836. The first 
routine is the initialize printer routine and the second is 
the output character to printer routine. Both routines save 
all registers except CC . A carry set condition is returned 
if the printer is not ready. 

You may write your own printer drivers because theife routines 
are vectored through RAM at locations SBDC9 and $BDCB . You 
may change $BDC9 to point to your printer initializing routine 
and $BDCB to point to your output character routine. Then 
you will be able to use all printer commands in XBASIC and 
those in ECHO for your own printer. Your routines must save 
all registers. The characters to be printed is in A and you 
should return a carry set condition if your printer is not 
ready . 
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Hexadecimal 
value 


Decimal 
value 


Control 
character 




Separate 
key 


Meaning 


00 
01 



1 


A 






Null 

Set inverse video 
mode 



03 



04 
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D 




05 


5 


E 




06 
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F 




07 
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G 




08 
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H 


BACK SPAC 


09 
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I 


TAB 


0A 


10 


J 


LINE FEED 


0B 


11 


K 





OD 


13 


M 


RETURN 


OE 


14 


N 




OF 


15 


. .0 




10 


16 


P 




11 


17 


Q 




12 


18 


R 




13 


19 


S 




14 


10 


T 





15 



21 



16 


22 


17 


23 


18 


24 


19 


25 


IB 


27 



ESCAPE 



Clear inverse video 
mode 

Disable Graphics 
Display 

Move cursor right 

Move cursor up 

Turn cursor on 

Enable Graphics 
Display 

: Back Space 

Horizontal Tab 

Line Feed 

Set cursor position 
(followed by X and Y) 

Form feed {clear 
screen) 

Return cursor to left 
margin 

Scroll screen up 

Turn cursor off 

Turn on digital clock 

Turn off digital clock 

No function 

Move cursor left 

Home cursor to top 
left 

Clear line that cursor 
is on 

Scroll screen down 

No function 

Move cursor down 

Read Graphic character >. 

Program graphics 
character 
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, ASCII CHARACTER CODES 

1968 ASCI I American Standard Code for Information Interchange. Standard 

No. X3.4 -1968 of the American National Standards Institue 
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Memory Map for Aamber Pc 



:gasu: 



June 1981 



F000. .FFFF 
E818. .EFFF 



E810 



E800 



E400 




E600 




E200 




D000 


• DFFF 


COOO 


.CFFF 


BEOO. 


.BFFF 


BDCO. 


.BDFF 


B000. 


.BDBF 


A000. 


-AFFF 


9000. 


.9FFF 


8000. 


. 8FFF 


7000. 


. 7FFF 


6000. 


. 6FFF 


5000. 


. 5FFF 


4000. 


.4FFF 


3000. 


.3FFF 


2000." 


2FFF J 


1000. 


IfFF 


0000. 


OFFF 



System Monitor, in EPROM Socket 1 
Reserved for future expansion 

Port' 4 General Purpose user interface] 
„ . ., / Requires I/O 

Port 3 Digital Cassette interface [ Expansion 

Port 2 Printer Port J Option 

Port 1 Calculator chip interface - on board PIA 
Port System PIA - reserved for use by Pegasus only 
Programmable Character RAM - not directly addressable 

Reserved for 
future expansion 

512 bytes for video RAM 

-64" bytes for System Monitor variabl* 



Standard User RAM, stack = $BDBF 



36K of address space reserved 

for RAM expansion under DAT control 



USER P I A CONNECTIONS 



(ufl/n arAcJ flA* rw.r«J *" *-fc« us O 



4K on-board RAJ . (#c) curved.- - \ 



o 







&$* 



EPROM Socket 2 
EPROM Socket 3 



I I— *•» * EU 

1IF - — ~ 



Uj Opf.'onal ?lA plu« J 

L)i OftiWl *™ r lu l .2 

C Cuj'S'We. inf'rfact pint. 

V Video ji'y»*l pf«tj 



' r. ut\ 



llr <~ - 

JUJ1M 
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Appendix 7 

SYSTEM MONITOR 2.0 RAM ALLOCATION 

The Aamber Pegasus Monitor reserves 96 bytes of Read/Write 
memory address range $BDA0 to $BDFF for system housekeeping 
A summary of useful locations is given below. 



functions . 



SBDCO INBUFF 



The keyboard uses the byte at this location as a 
single character buffer, before passing the character 
on to the input subroutines. Whenever a code is 
generated while the keyboard is enabled, then the 
character will be deposited in INBUFF, and the RXREADY 
flag will be set TRUE (non-zero) . A sample routine to 
use the keyboard as an input device is given below: - 
This routine is taken straight out of the monitor. 



TST RXREADY 
BEQ INPUT 
LDA INBUFF 
CLR RXREADY 
RTS 



Check the flag 
Loop if FALSE 
Get the character 
Clear flag for next ust 
End of subroutine 



The keyboard input will not work if FIRQs are disabled. 
If the character is not read from the buffer by the 
controlling program before the next key is typed, then 
it will write over the character that was there. Any 
ASCII character in INBUFF will be In the range $00..$7F. 
characters with the MSB set will be implemented for 
special functions in later Monitor releases. 



$BDC1 TICKS 



While FIRQs {Fast Interrupt ReQuests) are enabled, an 
interrupt will be generated every 20 milliseconds, which 
will be used (among other things) for incrementing the 
bytes at TICKS. The byte will be cleared everv 50 
interrupts, orovidina a mains-derived 1 
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SBDC4 MIWUTF.S 



This byte contains the minutes part of the system time, 
varying from to 59 as the time proceeds. 

$BDC5 HOURS 

This value changes every hour and forms a 24 hour 
clock that varies from to 23, where 12:00 is midday. 

5BDC6 *» Prt.,M-&K ou/of.f ( *a*OMj 
Reserved 



$BCC7~8 POC 

This value is always $55CC. 
will cause all of memory to 



If it is not then 
>e cleared. 



$BDC9-C fcf-7 
Reserved 

SBDCE-F 



f &>r- 



\kt> 



Program counter used by GO command 



$BDD0-3 &**eo 

. Reserved 



?BDD4 INVERT 



V 1 E CTC R- 



J 



This byte defines the invert state of characters as 

they are output to the video screen. When this byte 

is zero, characters ECHOED will appear dark on a light 

background; when this byte contains $80, they will appear 

light on a dark background. INVERT is cleared by the 

control-A code, and is set by control-B. 

Note that its normal state is with invert TRUE ($80). 



$BDD5 CLOCK 



second clock. 



SBDC2 TOCKS 



This byte controls the digital clock display, which will 
appear at the upper right of the screen. The clock is 
turned on by typing control-P at the keyboard, while 
control-Q will turn it off. 



The bvte is simila 

from 

powers 

housekeeping functions. 



to TICKS, exceot that it varies 



$BDD6 CURSOFF 



to 255 in 20ms intervals, and is divided by 
s of 2 to provide timing synchronisation for 



system 



$wcj fi/-;conw 



Derived from TICKS, this byte varies from to 59, 
and provides the seconds value for the system time, 
which may be set from the monitor using the 'T' function. 



When Minus (MSB set), the cursor is turned off. When 
zero the cursor is on (flashing) and when plus the 
cursor is on non flashing. Control and Control F when 
echoed to the screen will turn the cursor off or on resp. 
Once turned on the cursor can be made non flashing by 
storing a $01 in this byte. It is recommended that 
when updating the video RAM directly, the 'cursor should 
be turned off using the control-0 function, and then 
turned on again using control-0. 



$BDF4 MEMEND Stx-U 



This location is used to store the logical end of 
the user's read/write memory. The system stack 
usually originates here. The value stored in MEMEND 
by the system is SBDBF, but this value may be 
changed by user programs. 



SSBDE4 FINISH 



$BDF6 ABORT 



When the BREAK key on the keyboard is depressed, 
then the routine specified by the contents of this 
address is called as a subroutine. This is usually 
used in user programs to set a flag that tells the 
program to stop execution. The user routine must b€ 
very short and must not use direct addressing. 



$BDE6 RELOC 



^^^^s.-xrr^^a*s£ssr- 



This flag specifies, when non-zero that a f*l~ u ■ 
loaded in is to be relocated to the e s t is" 9 

stored in START. eiS tnat is 

NB - vLify n is r in°eS^t: W ^ ~" ""* * «««*. 



r* 



■^ 



$BDE7 AUTOLN 



$BDF8 LINES 



The number of lines displayed on the screen is controlled 
by this byte, which must always be in the range of 
to 16. Due to the nature of software scanned video 
generation, a reduction in the number of displayed 
lines will cause a significant increase in execution 
speed for all programs. 



Swsasas™! 



SBDE8 RAWFLAG 



$BDF9 XPOSIT 



The horizontal cursor position is maintained in this 
byte, and should always be in the range of to 31. It 
is preferred that any changes to XPOSIT or YPOSIT be 
made through use of the appropriate control codes, 
rather than through writing directly into them. If you 
want to write to them directly the cursor must be 
turned off while you do this. 

$BDFA YPOSIT 

Vertical cursor position is stored here, which is a 
number in the range of to 15. 

$BDFB Reserved for system 2^ 

$BDFC INPUT VECTOR fK> 

The sytem keyboard input routine is vectored through 
this location, and may be re-vectored to a user routine. 
If these locations are corrupted, then the keyboard 
will stop working until an NMI occurs. 



SBDE9 
5BDEA 



l5 i ?h"S„i?or°?S ed v by thS left " hand ^labelled key. 

Reserved for system ft* 
IRQVECTOR (-e-y% 

SSopScess2 Q tnf rSCeiVed fr ° m Pln 3 °" ^ "09 

t he :sss B SoSr.? r ??jr l ss;i? n is vectored to 



$BDEC SW11 VECTOR f$ >% 



in these two bytes transfer to th * address stored 
$BDEE SW12 VECTOR (-£0% 

The SW12 instruction will vector though here. 
$BDF0 SW13 VECTOR f-S^I 

The SW13 instruction will vector through here. 
$BDF2 MEMBEG 

sr te ™- * s "«-- s "i set: of 



SBDD7 Reserved by system *<* 
SBDD8 PAUSING 

When TRUE, this byte will cause output to the screen 
to be suspended. This function is turned on and off 
using the ESC (escape key, ASCII 27), and is used 
tor stopping print outs. 

$BDD9 RAWMODE 



5BDFE OUTPUT VECTOR Hit- 

The system output routine, ECHO, is vectored through 
this location, and can also be re-vectored if desired. 
This feature is used for things like output ting 
information to printers or other devices. 



When non-zero, this byte will cause any control codes 
that are echoed to be printed as a special character, 
without executing the appropriate control function. 
This byte must be control directly as there are no 
control codes to turn it on or off. 

SBDDA REREADY 

This flag indicates (when TRUE, or non-zero) that a 
character is ready in the INBUFF character buffer. 
This flag should be cleared after use. 

$BDDB to e 5BDpD Reserved for system use only. 

5BDDE KEYLOCK 

The keyboard may be locked out by setting this flaa 
TRUE . 

5BDDF CAPSLOCK 

This byte will invert the sense of the shift key for 
the letters A..Z on the keyboard, allowing upper or 
lower case to be used. This flag is toggled by the 
CAPS LOCK key towards the left side of the keyboard. 

5BDE0 Reserved by system 9 d> 

?SBDEI MSBINV 



Zi 



This is a general purpose toggle flag that is set and 
reset by the unlabelled key at the extreme lower right 
of the ASCII keyboard. In the Monitor this key is used 
to invert the most significant bit of characters typed 



subroutine - for instance, 



Tiny BASIC. 



GETLINE system 



5BDE2 START 



Two bytes are reserved here for storing the starting 
address of files that are saved using the cassette 



,,.,. , , , n g the cassette. 

t.nt.-i, Mies are loaded from cassette, then the starting 
here. 



address 



lo; 
placed 
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PRINTER ROUTINES 



MONITOR 2.3 



Monitor 2.3 has printer routines which will drive a 
Centronics parallel standard interface. Extended basic 
uses these routines directly. 

The ECHO routine in the monitor cah be configured to use 
these routines also. This means that you can record 
everything you do; make Tiny basic listings etc. Three 
control codes are used to set up this printing mode. 
Control 3 (hold both the control and shift keys down 
and pressl^]) is used to enable the printer to print 
everything sent to ECHO as well as having it appear on 
the screen. Control A sets the printer mode on while 
disabling the normal screen display. Control — (underbar) 
is used to revert back to normal output with printer off. 
All these codes may be typed in directly from the keyboard 
or can be sent from USER programs . 



EGIHNERS GUIDE TO 



PEGASUS 



INTRODICTION 



This book will teach you how to communicate with your 
Pegasus Computer. You will learn how to speak its language 
so that by giving it meaningful instructions you can make it 
do what you want it to do. That's all programming is, by 
the way. 



There are many computer languages. Your Pegasus understands 
a language called PEGASUS EASIC which is a simplified form 
of BASIC (BASIC stands for Beginner's All-purpose Symbolic 
Instruction Code) . 



BASIC is perhaps the best language for the beginning micro- 
computer programmer. It is easily learned (as you will soon 
see) and programs may be developed quickly. For the more 
experienced programmer BASIC can form the basis of a system 
whose sophistication may be indefinitely extended. 



So let's get started. Get to know your Pegasus. 
It can do an infinite number of things for you. 
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Chapter 1 
GETTING STARTED 



In this chapter we will introduce you to your 
Pegasus. You will learn how to use your keyboard 
and how to control the output display on your TV 
screen. 

Connect your computer by referring to the appro- 
priate section in your Computer Operation Manual. 

Switch it on and you will be greeted by the following 
heading on your television screen: 

AAMBER Pegasus 6809 
Technosys Research Laboratories 
Basic 1.0 
Monitor 1-0 
Select one of the above: 
Press T and your Pegasus will be 'ready' to go. 

Do you see the flashing light? This is called the 
cursor and it indicates to you where on the screen 
the characters you type in on the keyboard will be 
displayed. 

Try it. Type the following exactly as shown below: 

PRINT "HI, I'M YOUR PEGASUS COMPUTER" 

When you reach the end of the line on the screen, 
keep on typing. The last part of the message will 
appear on the next line automatically. (Notice that 
the screen can display a maximum of 32 characters.) 

Now check your line. Is it alright? 

If you made a mistake, no problem. Simply press the 
BACK SPACE key and you will observe the last 
character you typed will disappear. Press again, and 
the next will disappear, and so on 



This is what you should see on the screen: 

Ready 

PRINT "HI, I'M YOUR PEGASUS COMP 
UTER" 

Now press RETURN. This key tells the computer 
that you have finished the line. The computer 
then proceeds to execute it. 

Your screen will then display: 

Ready 

PRINT "HI, I'M YOUR PEGASUS COMP 
UTER" 

HI, I'M YOUR PEGASUS COMPUTER 

Ready 

As you can see, the computer has obeyed your 
command and is 'Ready' for more. 

Now type: 

PRINT "2 * 2" 

and press return. The computer obeys and prints 
your message: 



How about some answers.' Alright, try it without 
the quotation marks: 

PRINT 2*2 (RETURN) 

This time the computer prints something different 
the answer to the expression 2* 2 

Experiment further by typing the following: 



PRINT 3+4 (RETURN) 

PRINT "3+4 " (RETURN) 

PRINT "3+4 EQUALS", 3+4 (RETURN) 

PRINT 8/2, "IS 8/2" (RETURN) 

PRINT "6/2" (RETURN) 

PRINT 6/2 (RETURN) 



This demonstrates that the computer sees everything 
you type as either strings or numbers. If it is 
in quotation marks it is a string. If it is not in 
quotes, it is a number. The computer sees it 
exactly as it is. The number might be in the form 
of a numerical expression (e.g. 3+4) in which case 
the computer reduces it to a single value. 

By now it is likely that the computer has printed 
some unknown messages on your screen. If it hasn't, 
type the following, deliberately mispelling the word 
PRINT. 

PRIINT "HI" (RETURN) 



The computer prints: 



ERROR #4 



This indicates that the computer has detected a 
syntax error. You will have to type the line again 
properly. 

There are other types of errors, too. Try: 

PRINT 5/0 (RETURN) 

The computer prints: 

ERROR #8 

This indicates an impossible division by zero command. 



So whenever PEGASUS BASIC detects an error while 
executing a line it generates an error message, 
listing of error numbers and their corresponding 
meanings is given in Appendix 1. 
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CHAPTER 2 



NUMBERS, VARIABLES AND EXPRESSIONS 



Before we go on it is important that we understand 
the meanings of numbers, variables and expressions. 

NUMBERS 

PEGASUS BASIC is an integer BASIC, which means that 
all numbers in it have no fractional part, 
e.g. 3.7, 4.02 and 3.1415926 are not integers. 

Besides this there are two operating modes - signed 
and unsigned. When you first switch the machine on 
the computer automatically goes into the signed 
mode. In this mode integers in the range of 
-32768 to 32767 are only allowed. 

You can change to the unsigned mode by using the 
USIG statement. 

Type: USIG (RETURN) 

In tnis mode integers in the range to 65535 only 
are aliowsd. To return to the signed mode use the 
SIG statement. 



Type: SIG 



(RETURN) 



If you input a number outside the allowed range, or 
the intermediate or final result to a calculation is 
outside the allowed range, then an error message will 
be returned. 



VARIABLES 

In PEGASUS BASIC a variable is represented by a 
single capital letter (A to Z) which directly 
corresponds to a location in the computer memory - 
we call this the name of the variable. The value of 
the variable is the number stored there. 

For example, assign the variable A the value of 13 and 
the variable B the value of 7 by typing: 



LET A = 13 (RETURN) 
LET B = 7 (RETURN) 



As LET is used very often in computer programs, 
the computer will understand you if you leave out 
the work 'LET' altogether. From now on that is 
what we will do. 



OK. 



Now have the computer print out your number; 



Notice the use of commas in the print statement. 
Your computer will remember your assigned values 
for A and B as long as it is switched on, or until 
you decide to change them. 
Do this by typing: 

A = 15 (RETURN) 

Then, when you ask it to print A it will print 15. 



EXPRESSIONS 

An expression is a combination of one or more 
numbers, variables or functions joined by operators. 
You are probably most familiar with the following 
mathematical operators. 

+ addition 

- subtraction 

* multiplication 

/ division 

Lets say that we want to divide the sum of 9 and 6 by 
3. You might write this as: 

9 + 6/3 
Now try it on your computer. 

Type: PRINT 9+6/3 (RETURN) 

Is this the right answer to the problem? No, it 
isn't-' This is because your computer has first 
worked out 6 divided by 3 (that's 2) and added this to 
9 to give 11. 

This demonstrates the way that the computer works out 
arithmetic problems. The computer looks first at the 
expression and does multiplication and division first. 
Then it does addition and subtraction. 

So, to get the computer to solve the problem 
differently, you must use parentheses. 



Type it as: PRINT {9 + 6) /3 (RETURN) 

That's better. The computer solves the expression 
in parentheses before doing anything else. 

What will your computer print in answer to the 
following problems. 

PRINT 12 - (6 - 4) /2 

PRINT 12-6-4/2 

PRINT (12 - 6 - 4) /2 

PRINT (12 - 6) - 4 /2 

PRINT 12 - (6-4 /2) 

Check by typing them out. 

Now see what happens if you type in: 

PRINT (12 - (6-4)) /2 (RETURN) 

If the computer sees a problem with more than one 
set of parentheses it solves the inside parentheses 
first and moves to the outside parentheses. 
In other words, it does it like this: 



(12 - (6 - 4) /2 



(12 - 2) /2 
19/2 



— »6 - 4 - 2 
->12 - 2 = 10 
■»10/2 = 5 



Can you imagine any problem with integer division? 
What is 13/5? 

Try it: PRINT 13/5 (RETURN) 

It gives 2 which is the whole number part of the 
result. If you want the remainder use the MOD 
operation. 

Try it: PRINT 13 HOD 5 

It gives 3. You can use MOD just like you use 
*,/,+, and -. 

There are other classes of operators available in 
PEGASUS BASIC besides the mathematical operators - 
we'll look into these in later chapters. 



As stated in the definintion you can also include 
variables in expressions. 



Try it by typing: PRINT A/3 + B (RETURN) 



(Remember A was 15 and B was 7). This feature is 
particularly useful in programs that we shall soon 



CHAPTER 3 



INTRODUCTION TO PROGRAMMING 



Type: NEW ( RETURN) 

This is just to erase anything that might be in 
the computer memory. 

Now type this line (don't forget the line number, 
10) : 

10 PRINT "HI, I'M YOUR PEGASUS COMPUTER" (RETURN) 

Nothing happened, did it? What you have done is 
to type your first program. 

Next type: RUN (RETURN) 

And now you have just run it. Type RUN again - and 
yes it runs again. Add another two lines to the 
program. 

Type: 20 PRINT "GIVE ME A NUMBER" (RETURN) 

30 PRINT "AND I WILL DOUBLE IT" (RETURN) 

Then type: LIST (RETURN) 

Your computer obeys by listing the program. Your 
screen should look like this: 

10 PRINT "HI, I'M YOUR PEGASUS CO 
MPUTER" 



20 PRINT "GIVE ME A NUMBER" 

30 PRINT "AND I WILL DOUBLE IT" 

Don't attempt to type in the number because your 
computer is not ready for it. 

Add the line: 40 INPUT T (RETURN) 

Add one more line: 50 PRINT "2 TIMES", T," IS " , 2*T 

Now list again, and your program should look like this: 

10 PRINT "HI, I'M YOUR PEGASUS CO 
MPUTER" 

20 PRINT "GIVE ME A NUMBER" 

30 PRINT "AND I WILL DOUBLE IT" 

40 INPUT T 

50 PRINT "2 TIMES", T/' IS ",2*T 



Now run it. The Input statement prompts you with a 
question mark. Type in a number (integers only, 
remember, which the computer will label T) and then 
(RETURN) , 

Didn't you do well J This is what you should have 
got (depending on the number, of course) ; 

HI, I'M YOUR PEGASUS COMPUTER 

GIVE ME A NUMBER 

AND I WILL DOUBLE IT 

? 9 

2 TIME 9 IS 18 



Run this program a few more times, 
different numbers. 



inputting 



Now add another line. 

Type: 60 GOTO 10 (RETURN) 

And run it the program runs over and over again 

without stopping. That last GOTO statement tells the 
computer to go back to line 10. This is called a loop, 
and in this program it will cause it to run 
perpetually. However, you can get out of it by press- 
ing the BREAK key, then any number and RETURN. 

Change line 60 so that it goes to another line number. 
How do we change a program line? Simply by retyping 
it, using the same line number. 

Type: 60 GOTO 50 

Your program listing should then look like: 

10 PRINT "HI, I'M YOUR PEGASUS CO 
MPUTER" 

20 PRINT "GIVE ME A NUMBER" 

30 PRINT "AND I WILL DOUBLE IT" 

40 INPUT T 

50 PRINT "2 TIMES ",T," IS ",2*T 

6 GOTO 50 



Run it OK, press the BREAK key when you have 

seen enough. There is a more desirable way of getting 
out of the loop. Why not get the computer to politely 
ask if you want to end it? 



Change line 60 
DONE AGAIN?" 



And add these lines: 
80 IF R - 89 GOTO 20 



follows: 
70 R 



60 PRINT "DO YOU WANT IT 
■■ 1NKEY : IF R = GOTO 70 
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Then run the program ....type your number... then type 
Y and the program loops back again. If you type any- 
thing else (e.g. 'N'), the program stops. 

This is what the program looks like: 



10 PRINT "HI 
MPUTER" 
20 PRINT 
30 PRINT 
4 INPUT 
50 PRINT 
6 PRINT 



I'M YOUR PEGASUS CO 



GIVE TIE A NUMBER" 
AND I WILL DOUBLE IT' 



2 TIMES ",T, " IS ",2*T 

DO YOU WANT IT DONE AGAIN?' 



INKEY- 



GOTO 7 



)9 GOTO 20 



What are these new lines? Line 60 is simply a 
printed question. Line 70 is in fact two lines, the 
two statements being separated by the colon ' : ' . 
The first part assigns the ASCII equivalent of the 
key depressed on the keyboard to the variable R. 
(ASCII is the American Standards Code for 
Information Interchange) . If no key is pressed 
then R is assigned O. The second part of the line 
tests for this condition and loops back to INKEY if 
it is true. However, as soon as a key is depressed 
it gets out of the loop and proceeds to the next line. . 

Line 80 tells the computer to go to Line 20, IF, 
(and only if) the Y key (That's ASCII 89) has been 
depressed. If not the program ends as there are 
no more lines after this. 

This chapter has covered a lot of important concepts 
of PEGASUS BASIC. Don't worry if some of these things 
are not absolutely clear at this stage. Experiment 
with your computer, and above all, enjoy it. 
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CHAPTER 4 



MORE PROGRAMMING 



In this chapter we will practise using functions 
and statements in PEGASUS BASIC. 



Type this: 10 FOR X - 1 TO 10 

20 PRINT "X =", X 

30 NEXT X 

40 PRINT "FINISHED" 

Run the program. See how it has printed X for X 
= 1- TO 10. Now replace line 10 with the following: 

10 FOR X = 5 TO 8 

And run again. Let's look at the program listing. 

10 FOR X - 5 TO 8 

20 PRINT "X =", X 

30 NEXT X 

4 PRINT "FINISHED" 

It's clear that line 10 determines that starting 
and ending values of the variable X. Line 30 tells 
the computer to get the next number - the next X - 
and to jump back to the line following the FOR ... 
TO ... line. (i.e. line 20) until it reaches the 
last number. At this stage it goes straight on to 
execute the final statement. We can further 
investigate the path of program execution by using 
the TRON statement. Try it. 

Type: TRON (RETURN) 

Now run the program again. This statement has turned 
on a trace, which provides a line number listing for 
statements as they are executed. The trace should 
look like this: 

<10> <2 0> X = 5 

<30> <20> X = 6 

<30> <20> X = 7 

C307 <20> X = 8 

<30> <4 0> FINISHED 

See how the program keeps jumping from line 30 to 
line 20 until it eventually goes from line 30 to line 
4 and stops. To turn the trace off, type: TROFF 
(RETURN) 
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If you like, run your program again to see if the 
race has gone. 

An extra feature of the FOR... TO... statement is that 
you can specify the actual STEP size. Change line 10 
to read: 

10 FOR X = 2 TO 10 STEP 2 

And run the program. See how X goes from 2 to 10 in 
steps of 2. Before, when we didn't specify the 
step size, it assumed STEP 1. What will happen if line 
10 is replaced with: 

10 FOR X = 3 TO STEP 3 

Try it... and see that it loops back only for X 10 

HOW about: 10 FOR X = 10 TO 1 STEP - 1 

Yes, it counts backwards too. 

Now try a new program - that's right, type NEW and 
(RETURN) - the type: 

10 FOR X = 1 TO 3 

20 PRINT "X =" , X 

30 FOR Y = 1 TO 2 

4 PRINT "Y = ", Y 

50 NEXT Y 

60 NEXT X 

Run it ... This is what you should get: 

X = 1 

Y = 1 

Y = 2 
X = 2 

Y = 1 

Y = 2 
X = 3 

Y - 1 

Y - 2 

Notice how it loops within another loop. Programmers 
call this a 'nested' loop. 

Now for something completely different. Type in this 
new program: 

10 S = RND /26 

2 PRINT "GUESS THE NUMBER" 

30 INPUT G 

4 IF G * 5 THEN GOTO 70 
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50 PRINT "NO, TRY AGAIN" 

60 GOTO 30 

70 PRINT "YES, THAT'S IT" 

And run it... guess numbers between and 9 
inclusive (the division by 26 in line 10 gives us 
this range) . 

The new statement type encountered here is the IF 
... THEN conditional statement. The statement tests 
the expression G = 5 and IF false will skip immediately 
to the* next line; but IF that statement is true THEN 
it executes the next statement GOTO 70. 

This condition is often the result of a relational 
operation. In BASIC these are; 

= equal to O not equal to 

^ less than ^ greater than 

^= less than or equal to /= greaten than or 
equal to 



These are often combined with logical- operators 

AND, OR, NOT to perform quite complex tests, here's 
an example: 
600 IF A = OR (C 127 AND D 0) GOTO 100 

This will cause a branch to line 100 if A is equal 
to or if both C is less than 127 and D is not equal 
to zero . 

This type of expression essentially evaluates to 
for false and -1 for true. Besides being used from 
true/false evaluation, logical operators can operate 
on binary numbers. 

For example, type: PRINT 6 and 7 (RETURN) 

This gives decimal 6 which is 0110 ANDed with 0111 

So far we have been looking at relatively short 
programs. Before long you will be so proficient with 
your Pegasus that you will be writing quite long and 
complex programs. 

We'll now look at some expressions which will help us 
keep things in order. Type and run the following 
program. 

10 PRINT " EXECTING THE MAIM PROGRAM" 

20 GOSUB 4 00 

3 PRING "NOW, BACK IN MAIN PROGRAM" 

40 END 
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400 PRINT "EXECUTING THE SUBROUTINE" 

410 RETURN 

Line 20 tells the computer to go to the subroutine 
beginning at line 400. RETURN tells the computer to 
continue execution with the line following the GOSUB 
expression. The END expression is necessary to 
separate the main program from the subroutine. 

Subroutines are written for operations that are 
frequently required. They result in economy of 
effort when it comes to writing programs. 

One final point - you can use the REM statement to 
place remarks and comments throughout your program. 
Anything following the REM statement is ignored. 
These remarks are often placed at different points 
in a program, particularly at the beginning of 
subroutines, to explain how unclear or complicated 
sections of the program work. 

Here is a final program that illustrates these 
points. Try it. 

10 REM THIS PROGRAM RAISES A 

20 REM NUMBER TO AN EXPONENT 

30 INPUT "NUMBER"N 

40 INPUT "EXPONENT"E 

50 GOSUB 1000 

60 PRINT:PRINT N, " EXPONENT ",E" IS ",A 

70 END 

80 REM // 

100 REM THIS SUBROUTINE DOES 

1010 REM THE ACTUAL EXPONENTIATION 

1015 IF E=0 THEN A=l: RETURN 

1020 A=l 

1030 FOR X-l TO E 

1040 A=A*N 

1050 NEXT X 

107 RETURN 



By now you should feel that you are in complete control 
of your Pegasus. Try writing some programs of your own. 



Good luck, and have funl 
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A GENTLE INTRODUCTION TO PEGASUS BASIC 



The BASIC Language 

BASIC is the most commonly used computer language 
in the world today. The word BASIC is an acronym, 
standing for Beginners All-purpose Symbolic 
Instruction Code. 

BASIC is a computer program that was originally 
developed at Dartmouth College in the U.S. as a 
means of teaching students the principles of 
computer fundamentals, as well as making it easier 
to write computer programs. BASIC itself is usually 
written in machine code assembler, although higher- 
level languages have been used. 

Bells and Whistles 

Hundredsof BASIC interpreters (i.e. programs that 
will accept and interpret a program written in BASIC) 
have been written since the first version, and each 
one is usually unique in its features and limitations. 
Theoretically anyone with enough knowledge and time 
can write a BASIC interpreter, although notmany people 
so do. However, when they do, each likes to add a 
personal touch, in the form of special features, and 
this is known as adding Bells and Whilstles. (We 
have not stinted in this tradition) . Thus, although 
BASIC is common, there are many dialects. 



Where Do I Start: 



At the beginning, of course! We'll look at the idea 
that a computer program is like a recipe. For example 



let's make a milkshake; 



Fetch container 

Fetch milk 

Pour milk into container 

Fetch flavoured powder 

Add powder to milk in container 

Pick up container 

Shake! 

Oops! 

Put down container 

Clean up mess 

Put lid on container 

Shake! 

Take lid off 

Drink milkshake 

End of recipe 
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A trivial, almost useless, example. Each line 
or statement is a command or instruction (apart 
from "Oops! ' which is a comment or perhaps an 
invective) . The statements were executed 
sequentially, starting from the top. Note that 
each statement leaves out a very great amount of 
detail - like what sort of container was used, 
where the milk came from, what flavoured powder 
was used, even whether it was enjoyed or not! 

Computer programs are quite like this in their 
detail - a great deal is implicit or assumed. 
Computer programs are much simpler, however, in 
the actions that they describe, in that the tasks 
a computer performs are (usually) logical and 
straightforward - unlike the real world of gravity 
and spilt milk. 



Using Numbers 

BASIC, like many other computer languages, is 
designed to work with numbers. Usual operations in 
BASIC are addition, subtraction, multiplication and 
division (+,-,*,/). There are two ways that numbers 
are used in BASIC - constants and variables. 

A constant has a value which it keeps for as long as 
the program runs. Typical constants are 7, 24, 0, 
-32768, 2000. Variables are symbols for memory 
cells that may contain numbers. In Pegasus BASIC 
we use the letters A through to Z to represent these 
variables. Thus we can refer to a variable in a 
computer program without having to know its value. 
When a computer program is first RUN, all variables, 
A to Z, will have a value of zero. 



Number Size 

Pegasus BASIC is an integer BASIC, which means that 
all numbers in it have no fractional part. E.g. 3.7, 
4.02 and 3,1415926 are not integers. Further, the 
Pegasus has 16 bit signed two's complement and 16 bit 
unsigned numbers, which means that for signed numbers 
you are limited to -32768 to 32767, while unsigned 
integers have a range of to 65535. Any outside 
this range will cause an error. 

Number Representation 

Numbers are stored internally in binary, but to make 
it easier for people to handle them, we have provided 
two forms of integer format: numbers may be output 
(printed) in decimal or hexadecimal (base 16) . For 
instance, if variable A contains 19, then we can print 
the two forms thus: 



PRINT A," ",HEX(A) 
which will print out: 

19 13 
For inputting numbers, they must always be in 
decimal, but may be signed or unsigned. Hexadecimal 
numbers may be used directly in a program by pre- 
ceeding them with a dollar sign ($), e.g.: 

PRING $13 
will print: 

19 
on your television screen. Both signed and unsigned 
numbers may be used and may be selected with two 
statements, SIG and USIG, which stand for signed and 
unsigned. Signed numbers have a range of -32768 to 
+32767, while unsigned are in the range of to 
65535. Note that an unsigned number greater than 
32767 will be printed as a negative number if the 
program switches back to the signed mode. 

Arithmetic 

In BASIC, arithmetic may be done with expressions. An 
expression is a group of tokens, each of which has a 
definite value associated with it, that is built up 
using a set of possible operators, and is solved as an 
algebraeic expression that returns a single numeric 
value. Now that we have confused you, let's clear 
it up with some examples: 

A*3+7*R 

(3+Q)-(21/L+(8*I) ) Note that the parentheses must 
match 

2+2 

1 yes, a number is an expression 

too 

S4F OR 51 note the Boolean operator 

ABS(-R) functions are expressions too 

A variable or constant by itself may also be considered 
an expression, and expressions may consist of other 
expressions, as long as they are logically organised, 
and the number of left and right parentheses match 
correctly. Unlike some BASICS, nearly any complexity 
of expressions can be used. 



Operators 

Constants, functions, variables and expressions may be 
related by operators to form a new expression. All 
the operators work with 16 bit integers, and return 
16 bit integers as results. 
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/ 

MOD 



NOT 
AND 
OR 



simple addition 

subtraction 

multiplication 

divison 

modulus, same as taking remainder after a 

division instead of the quotient. 

e.g. 7 MOD 6 yeilds 1. 

unary plus, e.g. +7 by itself 

unary minus, e.g. - 12 

returns one's complement, e.g. NOT 

$F012 returns $0FED. 

logical AND, may also be used as Eoolean 

connector 

logical OR, similar to AND 



Note that expressions are no good unless you do 
something with them, using one of the statements 
available. The simplest statement to use is the 
assignment statement, LET. This is used for 
assigning values to variables, e.g. 

LET Q=I+9 The '=' means 'is assigned' 

L=17*(8+T) MOD 15 The LET is optional 

1=1+1 

The last statement is of particular interest since 
it illustrates how a variable is fetched, incremented, 
and then stored back in the same memory cell again. 
The '=' sign does not mean 'equals', but means is 
assigned the value of ' . Note that 3=A or 3=7 are 
illegal and will give an error message- Spaces may 
be used freely in expressions, however, they may not 
be imbedded inside function or statement names. 

A quick way of using your Pegasus for math is to 
use the PRINT statement in conjunction with an 
expression. Remember that the question mark, '?', 
is shorthand for PRINT. For instance, ? 7*8 gives 
56. When expressions are evaluated, they are 
executed in an order defined by the operator preced- 
ence. This means that values that are conjoined by 
certain operators will be executed before others in 
an expression. The precedence order is as follows: 

1st constants, variables 

2nd functions (includes special @ function) 

3rd unary - or +, NOT 

4th operators * / MOD AND 

5th operators + - OR 

The order of evaluation may be changed by using 
parentheses. Some examples are given for your 
enjoyment: 



3+4 * 2+5 resolves to 16 

(3+4) * (2+5)evaluates to 49 
A special class of operator, the relational operator, 
is covered in the section on Booleans . 
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Booleans 



relational operators (lowest precedence) 



A Boolean expression is similar to an arithmetic 
expression, apart from the use of the realtional 
operators. Any relation evaluates to for false 
and non-zero for true. The most usual non-zero value 
found will be -1 {hex FFFF) . The relational 
operators are: 

= equality 
> greater than 
< less than 
y= greater than or equal to 

<= less than or equal to 
O not equal to 
Boolean expressions may be mixed with arithmetic 
expressions, leading to results like: 

A=B=C+1 
Boolean expressions may be used with the IF statement, 
e.g. 

IF Q=7 THEN END 
IF T THEN GOTO L 

Here, L is treated as an unsigned line number that 
the program will GOTO if T is non-zero. 

Statements and the Editor 

Program lines in BASIC are usally organised in a 
strictly sequential manner, using line numbers in the 
range of 1 to 65535. A program will consist of a 
series of lines, where each line consists of one or 
more statements (separated by the colon, ':') and 
is executed sequentially, except where a special 
statement will change the flow of program logic. 
Here is a sample program that will print out the 
integers between 1 and 10. 

10 1=0 : REM I IS ASSIGNED A VALUE OF ZERO 

20 1=1+1 : REM I IS INCREMENTED 

3 PRINT I : REM PRINT OUT THE VALUE CONTAINED 

IN I 

4 IF 1=10 THEN STOP % REM STOP WHEN I REACHES 

10 
50 GOTO 2 
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Follow the program through by hand, or better still, 
try it on your Pegasus. When typing the program in, 
terminate each line with the RETURN key, and correct 
any typing mistakes by using the BACK SPACE key. If 
you notice a mistake on a line that you have already 
left, simply re-type the correct version (with the 
same line number) and the old line will be auto- 
matically replaced. To remove a line entirely type 
the line number by itself, followed by the RETURN 
key. 

Experiment with your own programs to print out 
different sorts of number sequences, until you are 
fully satisfied with the material covered so far. 
If you have trouble stopping a program once you have 
started it, tap the break key. 



Summary of Statements 



expressions, string constants 
This statement will evaluate and print 
results of expressions, as well as 
printing string constants. 
A string constant is a collection of 
characters delimited by double quotes, e.g. 
"FRED NURKE WAS HERE" 
"THAT'S all FOLKS" 

Expressions will be evaluated, and the 
results printed, with nO leading or 
trailing spaces. String constants and 
expressions MUST be separated by commas. 
Upon completion of the print statement, 
the cursor will move to the beginning of 
the next line, unless the PRINT statement 
is terminated with a comma. The cursor may 
be positioned to anywhere on the screen at 
any stage in the PRINT by using the form 
E x <yl - For example, PRINT [lO,2X "HELLO", 
will move the cursor to column 10, line 2, 
and print "HELLO", leaving the cursor 
immediately after the 'O'. The vertical 
position 'y' is optional, but if it is 
included then it must be separated from the 
'x' column position by a comma. There are 
three functions that may only be used with 
the PRINT statement, since all of them produce 
some sort of output, without returning a 
value. These output functions are detailed 
below: 



CHR (expression) 

This will output the ASCII character 
that is represented by the result of 
the expression. The result is forced 
into the range of to 255 (decimal) , or 
$00 to $FF (hex) . If the number is 
greater than 127, then the character will 
be inverted. Note that characters in 
the range of to 31 and 128 to 159 will 
not print, but will cause one of the 
control functions to be executed. 

HEX (expression) 

The expression is evaluated, range to 
255, and the appropriate hex number is 
output, range $00 to $FF. 

RAW (expression) 

This function is very similar to CHR, 
except that values in the range of to 
31 and 128 to 159 will have a special 
character output, without executing the 
appropriate control function. 

Note that all functions that require an 
expression in brackets, must not have a 
space before the left parentheses. (The 
RAW function is associated with the RAT-JON 
and RAWOFF statements, covered later in this 
document.) Examples of their use are 
given below, for you to try on your Pegasus. 

PRINT "Print a hex number :" ,HEX (19) , CHR(IO), 

RAW ( ) 
PRINT CHR (,$46) , CHR ($52) , RAW ($45) , CHR ($44) 
PRINT "There are ",Q," beans in the box." 
PRINT CHR(12) : REM Clear screen 
PRINT RAW(12) : REM Output Greek letter 'nu 



LIST starting line, ending line 

Program lines may be listed out, either as 
individual lines, subranges of lines, or 
the entire program. The expressions are 
both optional, and are unsigned numbers 
always. If a line is specified that is 
not in the program, then the nearest one 
to it will be used. This is the only case 
in which such leniency is tolerated. If you 
try to force BASIC to use the 'nearest 1 line 
number in other statements, then a small 
quantity of plastic explosives attached to 
your Pegasus will be detonated, removing 
your typing fingers. 
YOU HAVE BEEN WARNED. 

Note that the starting and ending lines may 
be expressions, and the LIST statement may 
be part of a BASIC program. 

RUN expression 

The RUN statement will initialize all variables, 
then start program execution at the line 
number specified. If no number is specified, 
the program will start at the beginning. 



"string constant" input list 

This statement, unlike many others, can only 
be executed with a line number as part of a 
program. Its purpose is to request numbers 
from the user for input to the program. The 
string constant (if specified) will be 
printed out as a prompt to the user before 
input is requested, and must not be followed 
by a comma. When each input expression 

(yes, expressions can be input) is typed, it 
must be terminated with a RETURN key. Only 
one string constant may be specified, and if 
used it must be immediately after the INPUT. 



variable - start value TO end value STEP 
step-size. This is the standard BASIC 
looping statement. This will cause all 
statements between the FOR and its 
appropriate NEXT to be executed 
repeatedly until the variable's value 
reaches or exceeds the end value. Note 
that the step size may be positive or 
negative. If the step is not given, it 
will default to one. 

variable name 

Terminating statement for FOR loops. 

expression 

The expression will be evaluated to an 
unsigned 16 bit integer, and if a line is 
found with a matching line number, then 
that line will be executed next. 

expression 

The expression will be evaluated, and the 
subroutine which starts with the matching 
line number will be called, returning to 
after the GOSUB statement when it reaches 
and executes the RETURN statement. GOSUBs 
may be nested to any depth, depending upon 
free ram space for the stack. 



This statement indicates the logical end 
of a BASIC subroutine. 



The EXIT statement will return you back to 
the Pegasus Menu selection mode. 



XKV; 
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This statement will zero all variables, 
as well as deleting all program lines. 



The STOP statement will cause program 
execution to terminate, returning to the 
line edit mode. Execution may be 
continued with the CONT statement, as long 
as the program has not been changed. Any 
other immediate mode statement may be 
executed however . 



The END is similar to the STOP statement, 
except that the CONT statement will not 
continue program execution after an END 



The CONT will cause program execution to 
continue, as defined by the STOP and END 
statements. 



Any user remarks may appear after this 
statement, since they will be ignored by 
the BASIC interpreter. The REMark is 
terminated by the end of line or a colon. 

variable name = expression 

The assignment operation assigns the value 
of an expression to the named variable. Only 
variables and the special function ' @ ' may 
be used on the left side of the '=' sign. 
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expression THEN statement or expression 
The IF statement will evaluate the first 
expression, and if it is zero , then the 
remainder of the statement will be skipped, 
going to the next line. Upon a true state, 
then the part after the THEN will be 
executed if it is a statement, or if it is 
an expression, then it will be evaluated, 
and a GOTO will be executed. 



This statement will bring the trace mode into 
effect, whereby each line number will be 
printed out as the line is executed, following 
the flow of program execution as the RUN 
proceeds. 



This statement will turn the trace mode off, 



This forces the system to accept and print 
only signed numbers, in the range of -32768 
to +32767. A point to note here is this 
example: 

PRINT HEX($B010/256) will yield Bl, instead 
of the expected value of BO. This is 
because although the hex number is unsigned. 
SIGned mode is in effect, and must be 
disabled using USIG before the correct 
result may be achieved. 



The system can accept unsigned integers, in 
the range of to 65535, for input, output, 
and arithmetic expressions. Note that this 
mode is checked when determining whether the 
result of an expression is outside its range. 



SAVE 



BASIC programs are saved on cassette tape, 
with a filename that you may specify 
(8 characters only). The BLUE tagged lead 
goes into the MIC jack, while the YELLOW 
lead goes into the EAR jack. 



Previously EAVEd programs may be loaded from 
cassette tape. The filename and load area 
will be printed. 

POKE expression , expression 

The first value resolves as an unsigned 
16 bit address, which gives the location 
to poke the second value into. 



expression 

This statement controls the number of 
lines displayed on the screen. The 
expression must resolve to a number in the 
range of 1 to 16, or an error will stop 
execution of the program. Reducing the 
number of lines displayed has the result of 
speeding up program execution proportionally 



This statement will turn on the RAWHODE 
flag. This means that any control code that 
is echoed to the screen through the normal 
PRINT routine, or through typing in lines, 
will cause a special character from the 
character generator ROM to be printed, with- 
out executing the control function. 



Turns RAWMODE off , 



CLS 



This statement, when executed, will clear 
the video display screen, and move the 
cursor to the top left hand corner. 
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BASIC Functions 



Pegasus BASIC has a number of functions, 
each of which may be used in expressions, (apart from 
the ones specified in the PRINT statement description) . 
Note that there must be no spaces between the function 
name and the left parenthesis. 

ABS ( expression ) 

Takes absolute value of the argument. 

PEEK ( expression ) 

Returns byte at address given by expression. 



Returns number of free bytes available 
in system RAM. 



Returns pseudo-random number in the range 
to 255. 

USR ( expression ) 

Calls a machine language routine subroutine 
in memory at the address specified by the 
expression - the function value returned 
reflects the state of the X register, and 
may be data or an address pointing at more 
data. 



( expression ) 

Special function that implements a one 
dimensional integer array that utilises 
all available RAM space. The function may 
be used anywhere that a variable name is 
used, including in assignment statements. 
Unlike variables, the @ array is not clear* 
by the NEW statement. The array index is 



30 



unsigned, starts at zero, and its size 
is FREE/2-1 



This function will scan the keyboard to 
see if a key has been pressed - if one has, 
then its ASCII value in the range of 1 to 127 
will be returned, else if no key has been 
pressed then zero will be returned. 



Information for Experts 

The variables, since they are in fixed locations in 
RAM, ( in the 4K system only ) , can be accessed by 
machine code subroutines by referencing directly 
their addresses. There are 26 variables, and they 
start at $B03C. 

Nearly all tokens in BASIC have a shorthand form, 
for instances, '? ' means PRINT, and ' e ' means PEEK ( . 
Try finding out what the rest are - this information 
will be published in the newsletter. 

When a program is executing on the Pegasus, it may 
be stopped in its tracks by using the BREAK key on 
the keyboard. This is functionally equivalent to the 
program encountering a STOP statement. 

Output that is being sent to the screen may be paused 
by use of the ESCAPE key, on the upper left of the key- 
board. Tapping once will stop, tapping again will start. 

If inverse video characters are required inside strings, 
they may be effected by tapping the blank key on the 
extreme lower right of the keyboard. Tapping the key 
again will remove the inverted state. Note that only 
characters inside double quotes will remain inverted. 
Inverted characters may also be generated by setting the 
most significant bit of the byte for the ASCII character 
(ASCII equivalent greater than 128) . 



RAWMODE may be set and resent by tapping the blank key 
on lower right of keyboard, second one in. When in 
effect, any control characters typed will appear as a 
special printing character, without the appropriate 
control function being executed. 



Note that the RETURN key, being a control code, will 
not work as it should until the RAWHODE flag is turned 
off by tapping the second blank key again. This 
feature allows you to insert control codes into strings, 
and then the output of those control codes as 
characters or functions may be governed by use of the 
BASIC Statements RAWON and RAWOFF. 

BASIC may be re-entered from the monitor after using 
the PANIC button by jumping to $0B offset from its 
start. f££ 



Basic Error Numbers and Messages 

Whenever a syntax or eduction error occurs, then an 
error number will be printed out, each number matching 
to one of the error messages given below: 

(1) Out of Memory 

This means that there is insufficient RAM 
space between the program end and the stack 
to perform the last operation. 



(2) 



Invalid Line Number 

A line number was specified that either 

does not exist, or is illegal 



(3) 



Next Without For 

A NEXT statement was found without the 

appropriate FOR statement 



(4) Syntax Error 

This is a general error that occurs when- 
ever there is incorrect syntax in a program 
line 



(5) 



Return Without Gosub 

A RETURN statement was executed, but the 

system did not find a GOSUB to return to 



(6) Immediate Mode Illegal 

A statement was executed in immediate mode 
that is illegal for that mode 



(7) Overflow Error 

The results of an arithmetic operation exceed 
the current range specified 



(8) Divide by Zero 

An attempt was made to divide a number 
by zero. 

(9) Screen length Error 

The LINES statement must have an argument 
in the range of 1 to 16 only. 
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BASIC STRING IN PUT /OUT POT 



Subroutine 1000 stores a string of 32 characters beginning 
at $5800 + 32 * N, where N is an integer from to 31 if 
IK of RAM is used from $B800 to $BBFF. 



Line 1020 

Line 1030 
Line 1040 

Line 1050 

Line 1060 

Line 1070 



I is the memory location for string 
element of string number N 

inkey checks for a key pressed 

backspaces and deletes previous character 
from RAM 

returns from subroutine 

prints the character and stores it in 
location S + I 

puts a null at the end of the string 



Subroutine 2000 outputs the string for a given N 
Line 2010 -PEEK's the element of the string 

2020 -checks for the end null 



2O30 



-prints the string element and increment 
S for the next one. 



10 REM SAMPLE STRING I/O 
20 REM FOR BASIC 

30 

50 REM INPUT STRING 
100 N= :1 : GOSUBlOQOlEND 

ISO REM OUTPUT STRING 

200 M-l s G0SUB20O0: END 

500 

1000 REM STRING INPUT 

1020 I=*B800+32*N: S=i 

1030 K=INKEY,IF K=0 THEN 1030 

1040 IF K=e THEN PRINTCHRCS), 

lUoO IF K-13 THEN RETURN 

1060 PRINTCHR<K>,:P0KECS+I) Kz If q< — t-l*^ 

1070 POKE <S + I>,oi RETURN "' K,lF S<S3 THEN S=S+1;G0T0 

1 1 00 

2000 REM STRING OUTPUT 

2010 I=*BSOO+32*N:FOR S=l TO 32s r-PPPtr fc^r . 

2020 IF C=0 THEN 5-32^7 S:rItSrN S " 

9999 ™ CHR <^=NEXT 5:R E Tu5n 



S-S-liP0KE(S+I) 



: GOTO 1030 



To input or output a string, specify the string number and then 
use the appropriate subroutine. The input routine will wait 
for Keyboard input, ending with a RETURN. 



THEORY OF OPERATION - TECHNICAL SUMMARY 

Page numbers refer to the circuit diagrams. 

Page.l 

An AC supply of between 6 and 15 volts is rectified and clamped 
to between and 5 volts by the diode resistor combination. 
The 74LS14 Schmitt inverter provides rectangular pulses from 
this at 50Hz. 

A falling edge then triggers both halves of a 74LS123 monostable 
producing a 1ms low going vsync pulse from one and a 2ms low 
going pulse from the other. These pulses are synchronized to 
hsync by one half of the 74LS74 ensuring that vsync and hsync 
are locked together. The rising edge of this second pulse clocks 
the other half of the 74LS74 to produce an active high output 
delayed by 1ms from the termination of vsync. This in turn is 
gated with hsync by a 74LS3 2 OR gate to produce firq interrupt 
pulses to the processor once every hsync pulse while the output 
of tbe 74LS74 remains high. This is cleared under software 
control at the completion of each video frame via the clr bit 
of the 6821 Pi; 

The hsync pulse is derived from the master microprocessor clock 
(e) which is divided by 64 by two 74LS93 counters. Their outputs 
are gated by a 74LS21 and 74LS00 to produce an 8us hsync pulse 
every 64us as required for video synchronization. 

© 1981 Technosys Research Laboratories Ltd 



Page. 2 

The 6809 microprocessor has a 4MHz crystal providing a master 

clock (e) of 1MHz. Reset is accomplished at power on by an RC 

delay network and two 74LS14 Schmitt inverters. The non-maskable 

interrupt is utilized as an abort feature by coupling it to the 

on board PANIC push button. This button is debounced by an RC 

network and two more Schmitt inverters. 

The main address and data buses are buffered by a 74LS245 and 

two 74LS241's to provide expansion capability via the SS-50 bus 

edge connector. 



Page. 3 

The system chip selects are provided by three 74LS139's and some 
additional gating. Initially the top two address lines, al4 and 
a!5 are decoded into four 16k blocks which are further decoded 
by the other gates. The bottom 16k block is decoded by another 
half of a 74LS139 and al2 and al3 to provide four 4k blocks. 
The bottom two of these (rom2 and rom3) may be used for two 
optional roms (see memory map) . Note that the position of these 
two roms is selectable by jumpers on board. 

The top 16k block is further decoded by half a 74LS139 and al2 
and al3 to provide 4k block selects for roml, rom2 , and rom3 . 
Roml is the system monitor rom and occupies the top 4k of the 
memory map, rom2 and rom3 are the optional roms described above. 
The middle 4k of this 16k block is used for I/O operations 
and is further divided by another half 74LS139 to give chip 



selects for pial , pia2 and char ram, 



Note that these only occupy half of the 4k I/O block, the other 
half being reserved for I/O on additional boards. The next 16k 
block down is only partially utilized. The top 4k of it is 
decoded by half a 74LS139 to give four chip selects for rami 
through ram4 (Ik each) . These are the onboard ram chips, and 
the upper half of rami is used for video character storage. 
The rest of the circuitry, the 74LS21, 74LS08 and 74LS0O are used 
to provide a sel strobe when none of the onboard devices are 
selected. 



low transition (keypressed) will result in a pia handshaking 
interrupt. 
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The second (optional) pia is completely available to the user 
and all port lines are brought out to an edge connector. 
The expandable on board ram consists of six 2114 r s selected 
by ram2 through ram4 . 
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Roral, rom2, and rom3 select 2532 EPROMS as described above. The 
6821 PIA is dedicated to system usage. Its lines are used to 
control the keyboard, cassette and video circuitry. Eight lines 
of port A are used for two purposes. During video scan they 
control which row of each character is being displayed and 
during keyboard scan they set up which row of the key matrix 
is being scanned. The remaining two lines of port A are used 
for the cassette interface. One proyides serial data out via 
an RC network to the recorders microphone input and the other 
receives data in from the recorders earphone output. This data 
is first clipped by diodes and then squared by the 74LS14 and 
74LS04. 

Three lines of port B are used to provide the video control 
signals page, char and blank. A fourth control pulse, clr, 
is provided by the pia + s handshaking output. The remaining 
four port B data lines are configured as inputs from the 
keyboard columns. These are also fed to the 74LS20 so that any 
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The 74LS20 and the 74LS08 gating provides a select pulse to the 

2114 ram chips if one of three conditions is met. Firstly if 

page is low (signifying an access to the character generator 

ram) , secondly in rami is low (signifying a normal processor 

ram access) and thirdly if any access to (F600 - F7FF) occurs 

16 

(signifying a video scan cycle) . The read/write to this ram 

is organized so that only reads occur during page access via 

the 74LS00 gating (see software theory of operation) . 

The 74LS245 gates the rami access in the normal fashion. During 

video access data from the ram is fed to the programmable character 

generator ram and the rom character generator (66710) . These 

provide the necessary video data and character row selects 

are derived from the pia as previously described, 

On the programmable character ram, bit seven of the input data 

selects between the ram chips (via a 74LS86J and the r/w is 
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gated via a 74LS32 so that it is always high (read) except for 
when the char ram select is active. 



Page . 7 

The outputs from the two character generators are selected by 
the char line from the pia via two 74LS157 multiplexers. The 
selected output (char rom if char is low, char ram if char is 
high) is then loaded into a 74LS165 shift register. The clock 
timing for the shift register is generated by the 74LS04 and the 
series of RC networks, synchronized to the master clock (e) . 
The 74LS245 data buffer provides microprocessor access to the 
programmable character generator ram. 
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The 74LS157 multiplexes the eight columns of the keyboard (each 
with a pullup resistor) to four lines fed to the key inputs of 
the system pia. This is controlled by the pia's asc line. 
The most significant data bit from the video ram is fed to half 
the 74LS74 which is clocked by the shift register load pulse. 
This synchronizes it with each new byte of video data. The 
output from this flip flop is then used to selectively invert 
video data via a 74LS86, This provides individual polarity control 
of the on screen characters . 

Another 74LS32 is used to control blanking of video data via the 
blank signal from the system pia, Video data and sync are combined 
by a 4066 to produce composite video output. 
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